Skip to main content
Version: 4.3.x {testing}

Motor variables

info

Next variables are located in the folder /driver/motor.

VECTOR vs BLDC

All these parameters are present in both the VECTOR and BLDC motor control algorithms. However, BLDC algorithm uses only a pp parameter. Other parameters are there only for the embedded identification procedures (identlin, identrun, ...). Therefore, changing their values will not affect motor control performance.

Parameters

The parameters hereby shall define the motor connected to the controller. In some scenarios, the properly identified motor parameters are crucial for correct driver operation (e.g. sensorless mode in vector drive).

tip

All the motor parametres are automatically identified with the identrun and identlin procedure, no need to set it manually.

pp [pairs]

Number of motor pole pairs. This parameter is primarily required for correct speed computation.

tip
  • Motor with 4 poles -> 2 pole-pairs. Set pp = 2.
  • To get number of poles of a typical motor construction, count the rotor magnets.
caution

Need to be set manually.

psi [Wb]

The permanent magnet motor flux linkage. This parameter defines the main motor (synchronous machine) constant (the relation between voltage and speed as well as between the current and the torque).
To derive the KV constant, use the following formula: KVRPMperVOLT=(pp60)/(psi2π)KV_{RPM per VOLT} =( pp * 60 )/ (psi * 2 * \pi)

Special values:

ValueDescription
0ACIM - AC induction machine
1e-10synRM - synchronous reluctance motor

Rt [ohm]

Phase resisistance in the star model. This parameter reflects the phase-to-phase resistance divided by two. Note that the internal controller resistance as well as the resistance of the phase wires should be included.

Ld [Hennry]

D-axis phase inductance in the star model. This parameter reflects the phase-to-phase inductance divided by two, measured at zero current and when the rotor is positioned such that the stator teeth are aligned with the rotor teeth.

Lq [Hennry]

Q-axis phase inductance in the star model. This parameter reflects the phase-to-phase inductance divided by two, measured at zero current and when the rotor is positioned such that the stator teeth are in between the rotor teeth.

Dp [1/degC]

PM flux temperature hyperbolic derating in units per degree celsius.

Dt [1/degC]

Resistance temperature hyperbolic derating in units per degree celsius.

Da [1/Amp]

Aligned inductance hyperbolic derating in units per ampere.

tip

identlin procedure attempts to identify this parameter only when '-n' option is specified.

Dc [1/Amp]

Cross inductance hyperbolic derating in units per ampere.

tip

identlin procedure attempts to identify this parameter only when '-n' option is specified.


State variables

tip

Variables ended with "f" are filtered using the filter constants /driver/Kf and /driver/Kr.

odo [rev]

Motor mechanical revolutions since controller start. Note that the application may reset the accumulator.

voltageq [V]

voltage on BLDC

Actual value of phase voltage in Q axis (torque creating axis).

voltaged [V]

Actual value of phase voltage in D axis.

To get the actual total stator voltage (DC-side equivalent voltages), use this formula: Ustator=voltageq2+voltaged23U_{stator} = \sqrt{voltageq^2 + voltaged^2} * \sqrt{3}

currentq [A]

current on BLDC

Actual value of motor phase curent in Q axis (torque creating axis).

currentd [A]

Actual value of motor phase curent in D axis.

voltageqf [V]

Actual value of phase voltage in Q axis, filtered.

currentqf [A]

Actual value of motor phase curent in Q axis, filtered.

To get the actual total stator current, use this formula: Istator=currentq2+currentd2I_{stator} = \sqrt{currentq^2 + currentd^2}

rpmf [rpm]

Mechanical speed of the rotor shaft. Make sure that the motor pole-pair count 'pp' is set corectly.

Rthermistor [ohm]

Resistance of the thermistor connected to MTEMP input (typicaly, the motor temperature sensor)

Vthermistor [V]

Voltage reading of the MTEMP input.

mres [ohm]

Winding estimated resistance. This value is only obtained when there is flowing some current through the motor.


BLDC states

duty [%]

Actual motor PWM duty cycle.